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L The user types in a name. 



2. Presses carriage return... 



Name: 



Department: 



John Smith 



3. John's department is looked 
up and appears automatically 



Name: 



Department 



John Smith 



Accounting 



FUoi2F 5 



Time 



Client 

Send "RunApplication" 
command. No definitions, no 
state changes. 



Server 



ri 



Application loaded and initialized on 
server. Send reply message with new 
definitions supplied (form, fields). No 
state changes or commands. 



Process new definitions (create 
the form in the display 
according to specification) 



n 



Process any state changes 
(none). 



Process any commands 
(none). 



rs 



Wait for user interaction. 



User types in "John Smith". 
Client flags Name field as 
having value state change. 



User presses return key. 



Client sends 

ReturnKeyPressed command 
message. Includes all state 
changes in message (in this 
case, the Name field value), 
and unflags all state changes. 



New definitions applied (none). 



no 



State changes applied (Name field has 
value "John Smith"). 



ni 



Commands processed. In this case, 
the ReturnKeyPressed command 
causes the business rule to be fired. 
During the processing, the-database 
lookup occurs, and thej.server's 
Department field value is-eftarrged to 
"Accounting . That field is flaggeo as 
having value state change. 



Send reply message. Definitions 
(none), state changes (in this case, the 
Department field value), and unflags all 
state changes. 



TI3 



Process new definitions (none). 



-H4 



Process state changes 
(Department field given value 
"Accounting"). 



TIE 



Process any commands 
(none). 



COMMANDS 




"Login" 


Validate user and begin session 


"Logout" 


Terminate session 


"Get Task List" 


Request task list definitions - i.e. activities the user can explicitly choose to initiate 
from a central place. 


"Run Task" 


An item from the task list has been chosen, so open the corresponding window, 
custom package, or guide. A "window" contains a form in query, submit, or modify 
mode. An "custom package" contains list of forms, start form, start mode, associated 
icon, etc. so opening it opens it's start form. A "guide" is a sequence of 
prograiTiiriaDie ruie acuoris encapsulated into a single conuTianQ, wmcn can lea a trie 
udci inrougn a luriri im-in activity in a &iep~Dy*biep proce&s ^or any otner activity mat 

pan hp "cnHnfpH " ncinc tiiriora in tyi a Kl o riilpc^ 


"Get Schema Window" 


Request window definition containing a form. These windows have an associated 

mnH p fmiprv mnH i f\/ qi iVrmif tipta/^ anH pan hp nnp nanp nf a iam n H r\\KT ir»<->l nrlinrr a 
uiuuc muciy, uiuuuy, ouuiiui ncwy, culu \~ai i l/c unc tactile vji a wuiuuw illClUUlllg a 

auerv list window 


"Get Menu Bv Field Id" 


Exnand a DrocrramiTiablp mpnii which is associated with a data field 

LiApui IU U pi UtiailullHk/lV 11LC11U IVlllLll OJJULluLCU VV 1 LI L U viU LCI IICIU. 


"Close Window" 


Close a window currentlv onpn 

ci wiiiuuw Luiiciiiiy ul/cil. 


"Get Ouerv List Window" 


Rentiest a window definition containing a nnerv rpsult This can hp nnp nanp nf a 

IxCUUwl a WUIUUW UC1UUL1U1L V_vl LlClli 111 lli CI UUCly ICSUlli 1IUO \_01 L UC \J1 It Is CI I IC Ul Ct 

containing window whiclvalso "contains" a-schema window . 


"New Display Window" 


Open a window containing form in read-only mode. 


"Refresh Query List" 


Run a query again so that a results window contains up-to-date data 


"Submit" 


The "Submit" menu or toolbar button was pressed. 


"Query" 


The "Query" menu or toolbar button was pressed. 


"Modify" 


The "Modify" menu or toolbar button was pressed. 


"Get Schema Help" 


Request window definition containing help for a db-schema. 


"Get Field Help" 


Request window definition containing help for a field within a db-schema. 


"Return Key" 


The Return key was pressed. 


"Nuprin fhoicp" 


A /"I ck kck TYiPnii i fom ta/sic colorfon 
t\ Udla lllcilU. llcill Was &t-lC\_ltXl. 




r\ prugrairiinaDie iricnu, tuoiDar uutturi, or lonri uutton was pressed. 


"Set Default" 


The "Set to Default" menu or toolbar button was pressed. 


L/ispiay r ick List 


Present the user with a picklist (a list of data items returned by a query, mod ally 
uispiay cu ) ana request tne cnosen vaiue dg returneu via a Dei ect 1 ick List 

pnmmanH 

LUl 1 111 LCtl IU. . 


"Select Pick List" 


An ifrpm \a/aq qp1p<"+pH frrvm a rtifHiQl" 


"Onen URL" 


A TTRT. pmhpHHpH in a fnrm winHnw waq ^liiMrpH fancp thp TTRT fr» hp naxrio-afpH fr* 

in the user's web browser 


"Prompt User" 


The user is to be prompted to choose between a set of choices. 


"Prompt Response" 


The user has chosen from a nromnt 


"Cancel" 


A DromDt has been resnonded to bv the "Cancel" choice 


"Message Box" 


A message is to be disnlaved to the user 


"Load Entry" 


Reauest a form window to load entrv bv soecifvinff the offset into a auerv result list 


"Load Entry By ID" 


Reauest a form window to load entrv bv stjecifvinp" a uninup entrv id 

iX^.VJ UViJl ft, 1U1 11 1 FT U IUvYV IV/ lUdvi vl L LI Jr J J ptV.ll J 11 If, u U1UL|UC V^l ILL y IvL. 


"Open Attachment" 


An attachment was bppn splpctpd for disnlav 

ill l ULLUULllldU WOO L/ttl I 9vlV«L>lCU 1 Ul UlOL/iaV > 


"Gain Focus" 


A field on a form has crainprl innut fonis 


"Lose Focus" 


A field on a form has lost input focus. 


"Switch MoHp" 


A form \A/i nH cwaj iq i^hancrino 1 mnHp p ct froTn nupru ¥rs cnhmif 
n lumi wuiuuw uiaii^ui^ inuuc^ ^*r?* i-ifiii v-j lici y iu sul/iiui. 


"Drill Down" 


Tn a rpsiilf^ lief nr tahlp fiplrl an pnfru haQ hppn gpIpt+pH fr*i* PYnanHoH Hicr>la\7 


"Refresh Field" 


T InHatp fhp r*onfpntQ of a fiplH frnm fhp Hatahacp 


"Copy To New" 


The "Copy To New" menu or toolbar button was pressed 


"Do Named Search" 


A particular named search has been requested. These are stored queries that can be 
executed on command. 


"Keep Alive Session" 


Reset the session timeout. This enables the server to clean up inactive sessions. 


"Close Confirmation" 


Prompt the user to confirm close of an uncommitted window. 


"Select Close Confirmation" 


The users response to a CloseConfirrrtation request. 



States 



"Session - Window List" 


List of all windows, whether they are currently open, closed. 


"Window - FocusField" 


Field which currently has input focus for that window. 


"Window - Entries" 


The result of a query in a result list window (rows of data). 


"Window - SelectedEntries" 


In a result list or table held, the currently selected entries. 


"Window - Guide Wait" 


Whether or not the user is currently prompted in the context of a guide 


"Window - PromptTextList" 


The current contents of the prompt pane while running a guide 


"Window - ChangeFlag" 


Whether or not the window is currently marked as modified. 


"Window - 

PromptWindowState" 


Whether or not the prompt pane is visible. The prompt pane is an optional part of a 
schema window which can display messages modelessly, and is frequently used by 
form-fill-in guides. 


"Field -Value" 


The current value of a field (can be different types). 


"Field - Display - Visible" 


Visible vs. Hidden for a field. 


"Field - Display - Access" 


Read- Write vs. Read-only vs. Disabled for a field 


"Field - Display - 
MenuJName 


The current data menu associated with a field 


"Field - Display - LabelColor" 


The current color of the label associated with a field 


"Field -StatHistValue" 


The current contents of a special value type. This is the audit trail of changes to an 
enum "status" field, encoded into a special format. 


"Field -Diary Value" 


The current contents of a special value type. This is an append-only character field 
which always adds user/timestamp whenever an append occurs. The previous 
entries are read-only. 


"Field - TableFieldValue" 


The current contents of a special value type. This is an embedded query result list 
which contains a list of entry data which can change by a "Refresh Field" command. 


"Field - AttachFieldValue" 


The current contents of a special value type. This is a reference to, and attributes of, a 
file stored on the server which can be downloaded for display by the operating 
system (or browser). 


"Field - TableRowSelection" 


Which rows of a table field are currently selected. This refers to the user's ability to 
do multiple selection operations on a table field, and the ability of programmable 
rules to be affected by such selection. 



Definitions 



"Session Id" 


Unique session identification structure 


"Task List" 


T • 1 t '111/" * J L 1 

List of available forms, guides, custom packages 


"Field Definitions" 


1-1* 111 1 1 I'll" J • 1 1_ A 11 I 1 •/* i 

Field type, layout, validation range, display properties, etc. All the information to 
create a typed data field on a form. Can include data fields of type character, diary, 
integer, real/decimal, enum selection, date/time, attachment, and also static trim 

/"kl ntv\An 4~o ciipn n O Itt"»£ic nAvQC tovf l3nOlC \"Tx r\ iT*\T~\ fr*/^ ] C £ln<H Hata fanlo Hal/1 ( rtiionf 

clclilcrilb &ULII do llllCb, UUXco, IcAL IdUclO/ laU lAJIlllUla, dllU Udld IdUlc IlClvl ^d UUCly 

result list embedded within a form). 


"Menu Definitions" 


Hierachical data menu description which can be attached to a field. Labels for items, 
value for items, nested submenus. 


"Results List Definitions" 


Query results window description (e.g. column titles) 


"Field Help" 


The help text provided for a field by the custom package author 


"New Entry Id" 


The id of a new entry (for implementations in which each entry has exactly one 
window) 


"Schema Help" 


The help text provided for a form. 


"Task Custom package" 


Description of custom package entry point. 



